home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 32 / ac9016_1.zip / ASTROCLK.NEW < prev    next >
Text File  |  1990-04-14  |  17KB  |  303 lines
  1.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 1
  2.         Program Revision History
  3.  
  4.  
  5.         ASTROCLK REVISION HISTORY
  6.  
  7.               Each released version of ASTROCLK uses a four digit 
  8.         revision code such as 8805. The first two digits indicate the 
  9.         year and the second two digits indicate the week of the year. In 
  10.         some cases, an additional letter suffix is added to distinguish 
  11.         changes occuring within the same week. A partial week at the 
  12.         beginning or end of the year is counted as a full week. Using 
  13.         this method, a year will typically have 53 weeks although it is 
  14.         possible to have 54 weeks in a leap year (1972 is an example). 
  15.         The current year-week revision code is shown on the Julian Date 
  16.         display, Display Mode 7, in ASTROCLK.
  17.              This file records the recent revision history of program 
  18.         ASTROCLK through all of the minor twists and turns that usually 
  19.         accompany the evolution of such a program. (Early revision notes 
  20.         have been deleted from this file but are available on request.) 
  21.         It illustrates the tortuous process of maintaining and refining a 
  22.         program as ideas and problems are reported from every quarter. It 
  23.         may also be helpful to users who are upgrading from one version 
  24.         to another to find out what has changed. This file may also 
  25.         describe recent changes not included in the main documentation; 
  26.         compare the version numbers below with the main documentation.
  27.  
  28.                                                 David H. Ransom, Jr.
  29.  
  30.  
  31.         9016     04/15/90
  32.         -----------------
  33.         -Changed ephemeris format to UTC date and time rather than local.
  34.         -Added ephemeris epoch/equinox selection: Equinox of Date OR the 
  35.         current internal Standard Epoch (set using F8).
  36.         -Added PRINT OPTION to F2 Ephemeris Generation. Printer output is 
  37.         sent to the DOS device "PRN". Be sure printer is ready BEFORE
  38.         selecting it for output. Titles plus 55 lines of data are sent 
  39.         per page with auto formfeeds between pages and at the end. Note 
  40.         that "graphics characters" are included in the data lines; if 
  41.         these characters are not wanted, use FILE OPTION and edit out the 
  42.         unwanted characters.
  43.         -Added FILE OPTION to F2 Ephemeris Generation. Data are identical 
  44.         to PRINT OPTION above except are sent to file. Enter complete 
  45.         file name when requested; default file is ASTROCLK.EPH located in 
  46.         ASTROCLK path.
  47.         -Corrected time calculations for Minor Planets to avoid adding 
  48.         the correction for UTC to TDT/ET twice.
  49.         -Updated file ASTROCLK.MPC with osculating elements as of 1989 
  50.         OCT 1.0. Data taken from file ELEM892.MPC.
  51.         -Since Minor Planet elements are often published [in Sky and 
  52.         Telescope, for example] with T (Time of Perihelion) rather than M 
  53.         (Mean Anomaly), manual data entry now requests the user to select 
  54.         M or T and enter the desired value. For T, use the format:
  55.              DD[.DDD],MM,YYYY
  56.         When the input data are displayed for acceptance, only M is 
  57.         displayed; if T was entered, it has been converted to M. If T is 
  58.         input, then the program requests q (Perihelion Distance) instead 
  59.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 2
  60.         Program Revision History
  61.  
  62.         of a (Semi-Major Axis).
  63.         -Calculation of minor planet perihelion changed to date nearest 
  64.         the date of the osculating elements. Thus for reasonably current 
  65.         elements and if the minor planet is more than half way around in 
  66.         its orbit, the perihelion date may be in the future.
  67.         -Reworked manual data reentry ("Z") for Minor Planets to show 
  68.         prior data of osculating elements if present (from previous 
  69.         manual entry or from "X" catalog entry).
  70.         -Minor cosmetic changes to Precession screens for clarity.
  71.         -The main documentation remains unchanged from Version 8947.
  72.  
  73.         9014     04/02/90
  74.         -----------------
  75.         -Corrected a significant error in Minor Planet positions when 
  76.         data are read from Minor Planet Catalog ELEM891.MPC (Epoch 
  77.         B1950.0). For example, Mean Anomaly might be in error by as much 
  78.         as 0.5 degrees. The error was less serious when current data were 
  79.         used. Using ELEM891.MPC, ASTROCLK's J2000.0 calculated positions 
  80.         now agree with AA 1989 to typically less than five seconds or 
  81.         arcseconds. Thanks to Ward Harman for many hours of patient 
  82.         analysis which enabled us to pin down the problem.
  83.         -Changed minor planet calculations to make sure all calculations 
  84.         performed regardless of display mode. Under certain circumstances 
  85.         the equatorial coordinates (RA/DEC) were incorrect in Mode 0.
  86.         -Added "prior value" code to manual orbital data input ("Z" after 
  87.         "P" Planet Selection). Input routines modified to accept the 
  88.         usual formats for angles:
  89.              DDD[.DDD]
  90.              DDD,MM[.MMM]
  91.              DDD,MM,SS[.SSS]
  92.         Once data are entered, the values are retained and displayed on 
  93.         subsequent "Z" inputs. Press RETURN to leave an entry unchanged. 
  94.         The manually entered data are discarded when you exit ASTROCLK.
  95.         -Added "/" as a valid separator for date inputs. Dates may now be 
  96.         input as "dd/mm/yyyy" or "dd,mm,yyyy".
  97.         -Minor cosmetic changes in Minor Planet displays.
  98.         -The main documentation remains unchanged from Version 8947.
  99.  
  100.  
  101.         9012     03/21/90
  102.         -----------------
  103.         -Versions 9007 and 9010 were limited beta releases. This is the 
  104.         first public release since Version 8951. The main documentation, 
  105.         files ASTROCLK.DC1 and ASTROCLK.DC2, remains unchanged from 
  106.         Version 8947. All subsequent changes are described in these notes 
  107.         ONLY!
  108.         -Corrected color error on large digit navigation position.
  109.  
  110.         9010     03/08/90
  111.         -----------------
  112.         -Added "Zone x", where "x" represents the standard international 
  113.         time zone letter, to the local clock title (Display Mode 1). Zone 
  114.         Z is Greenwich, Zones A thru M are East Longitudes, and Zones N 
  115.         thru X are West Longitudes.
  116.         -Repaired error which could cause program to hang if navigation 
  117.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 3
  118.         Program Revision History
  119.  
  120.         is active and the key sequence F10+F2+F10 is entered to cancel 
  121.         navigation.
  122.         -Corrected nautical mile conversion factor to 6080.2 feet.
  123.  
  124.         9007     02/12/90
  125.         -----------------
  126.         -Version 9007 is a MAINTENANCE UPDATE in order to improve various 
  127.         navigation features and to correct several minor errors. The 
  128.         changes are described below and NOT in the main documentation 
  129.         which is unchanged from Version 8947.
  130.         -Special thanks to Captain Helge Brudvik of the Royal Viking Sky 
  131.         for the freedom of the bridge, and to Chief Officer Magnus Bakken 
  132.         for his practical demonstrations of navigation at sea (as well as 
  133.         many hours of pleasant conversation). The changes in this version 
  134.         have been made during a cruise around South America and reflect 
  135.         what I have learned and observed during that ten week period.
  136.         -Added large digit display for calculated position in navigation 
  137.         mode; press "N" to toggle navigation displays.
  138.         -Number of star sights which may be entered for navigation fix 
  139.         increased from three to seven maximum to conform with Air 
  140.         Almanac. When last star sight entered, press RETURN to stop data 
  141.         entry.
  142.         -Added DRIFT and DIRECTION to navigation to permit correction for 
  143.         combined wind and current effects. Enter using F10+F2.
  144.         -Corrected UT Time entry in F10+F2 Navigation Fix entry so that 
  145.         RETURN leaves time unchanged rather than resetting it to zero.
  146.         -Conversion factor for nautical miles corrected to 6082 feet.
  147.         -Suppressed "Federal/State Taxes Due" message on calendar for 
  148.         Easter Sunday on April 15th.
  149.         -Minor cosmetic changes in navigation functions.
  150.  
  151.         8951     12/21/89
  152.         -----------------
  153.         -Version 8951 is a MAINTENANCE UPDATE in order to correct various 
  154.         minor errors. The changes are described below and NOT in the main 
  155.         documentation.
  156.         -By popular request, the documentation is UNCHANGED from Version 
  157.         8947. The documentation will remain unchanged until the next 
  158.         major revision so the full documentation need not be reprinted 
  159.         for minor upgrades in the program. All changes are documented in 
  160.         files ASTROCLK.HST and ASTROCLK.NEW only.
  161.         -The default responses (pressing RETURN/ENTER only) when using F6 
  162.         and SHIFT-F6 to enter new LOCAL or DESTINATION coordinates were 
  163.         incorrect and reset the new value instead of using the prior 
  164.         value. The prompts have been improved and the logic has been 
  165.         repaired. Note that the ELEVATION is now left UNCHANGED as the 
  166.         default response. Thanks to Bob Khron for the bug report!
  167.         -SHIFT-F6 may now be used to review the DESTINATION coordinates 
  168.         and name. Press RETURN to leave all data unchanged.
  169.         -When navigation is active and SPEED is non-zero, the calculated 
  170.         position window includes the date and time of the last navigation 
  171.         fix: "Fix @ 12-11-1989 15:30 UT" to remind the user when the last 
  172.         fix was entered or calculated.
  173.         -Dead reckoning positions were calculated one second behind the 
  174.         current time when the clocks were ON. I sure hope nobody crashed 
  175.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 4
  176.         Program Revision History
  177.  
  178.         on account of that one!
  179.         -Added Leap Second at end of 1989 to Delta AT table.
  180.  
  181.         8947     11/19/89   
  182.         -----------------
  183.         -Improved Apparent Geocentric Equatorial Coordinates for internal 
  184.         database stars and catalog stars, mean to apparent position, to 
  185.         include effects of nutation and annual aberration. Parallax NOT 
  186.         included. Apparent coordinates are now accurate to within one 
  187.         second/arc-second.
  188.         -Added navigation function F5 to show first 20 USNO stars in view 
  189.         and suitable for star sights. Uses current coordinates and time.
  190.         -Revised external star catalog logic. Search times halved and 
  191.         direct access by catalog number is now immediate.
  192.         -Expanded external star catalog searches F5+F4 and F5+F5 to show 
  193.         list of 10 stars nearest the coordinates input.
  194.         -Repaired SUB Refract to give correct answer when converting 
  195.         apparent to real altitudes and adjusted the navigation example 
  196.         data accordingly. Real to apparent was OK.
  197.         -Fixed horizon dip calculation (misplaced decimal point in a 
  198.         constant).
  199.         -Added SHIFT-F6 for entry of DESTINATION data using external city 
  200.         file and updated HELP.
  201.         -Added '/' prefix to F6 and SHIFT-F6 city name input to allow 
  202.         match within name.
  203.         -Improved degree input routine for small negative angles; now 
  204.         processes both "-0,26" and "0,-26" correctly. A minus sign 
  205.         anywhere flags a negative angle.
  206.         -Fixed "Division by Zero" error in navigation mode when speed was 
  207.         set to zero.
  208.         -Corrected Planetary Heliocentric Longitude to remove multiples 
  209.         of 360 degrees.
  210.         -Corrected USNO coordinates per AA 1989.
  211.         -Corrected paging problem with ephemeris if more than 40 
  212.         intervals requested.
  213.         -ASTROCLK.INI now always written on exit.
  214.         -Reformatted these notes to use a little less paper ...
  215.  
  216.         8943     10/25/89   
  217.         -----------------
  218.         NOTE: Program operation with Navigation DISABLED is essentially 
  219.         unchanged from previous versions. See also the notes which follow 
  220.         and the program documentation.
  221.         -MAJOR UPGRADE: F10 is now NAVIGATION. May be used to predict 
  222.         current position by DEAD RECKONING and by SIGHT REDUCTION of USNO 
  223.         Standard Navigation Stars. Added new NAVIGATION section in 
  224.         documentation with discussion and instructions.
  225.         -Added ASTROCLK Errors 60 thru 62 if a Navigation function is 
  226.         requested and Naviga-tion mode has not been set up with F10.
  227.         -Added ALT-F6 to set LOCAL CONDITIONS of Elevation, Temperature 
  228.         and Pressure. Affects apparent ALTITUDE of target object and 
  229.         adjusts for horizon dip with elevation. Elevation is saved but 
  230.         temperature and pressure are initialized to 20C (68F) and 1010mb 
  231.         (29.83") respectively upon startup.
  232.         -Corrected calculation of Greenwich Hour Angle [GHA] on Target 
  233.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 5
  234.         Program Revision History
  235.  
  236.         Tracking Display per Nautical Almanac 1989. (How did that slip by 
  237.         for so long?)
  238.         -Fixed minor error in SUB ZoneName so that Local STANDARD Time is 
  239.         displayed correctly in Dual Time displays for modes 2 thru 5. 
  240.         Clarified text in DUAL TIME section.
  241.         -ALT-F5 now sets POLARIS as target, moved from F10. [ALT-F10 is 
  242.         unchanged.]
  243.         -Added designation [Ho] for Apparent or Observed Altitude on 
  244.         Target Tracking Display.
  245.         -Improved accuracy of SUB AngleDiff for very small angles.
  246.         -Extensive reorganization and cleanup to add NAVIGATION mode and 
  247.         to relieve memory constraints with QB4 compiler.
  248.         -Deleted revision notes for versions 8905 and earlier. Available 
  249.         on request.
  250.  
  251.         8935      8/30/89   
  252.         -----------------
  253.         -Changed F2 to display an EPHEMERIS of the current target object. 
  254.         User sets interval and number of intervals with F2. Use the 
  255.         "PrtSc" key to print. Added by popular request!
  256.         -Added manual entry menu of orbital para-meters for planetary 
  257.         objects using "Z" command on planet selection menu ("P" command).
  258.         -Added Day-of-Year (current year, JAN 1 = 1) to F3 date input. 
  259.         Any time input is ignored. Allowed DOY formats are (quantities in 
  260.         [] are optional):
  261.              Dnnn[.nnnn]
  262.              Dnnn:hh[.hhhh]
  263.              Dnnn:hh:mm.mm[.mm]
  264.              Dnnn:hh:mm:ss[.ss]
  265.         Times are UT. The comma is also allowed as the separator.
  266.         -Changed date input using F3 to allow JD with no letter prefix. 
  267.         Eliminated QB4 error in this case.
  268.         -Removed on screen HELP from ASTROCLK code and added program 
  269.         ASTROHLP. Operation of help using Function Key F1 is unchanged. 
  270.         Saved about 10K of RAM compared to V8931, all but about 3K of 
  271.         which was consumed by new features. Also corrected/updated the 
  272.         help screens. Modified in response to user requests to reduce RAM 
  273.         requirements!
  274.         -Added SHIFT-F9 to execute a preset DOS command or batch file. 
  275.         Use ALT-F10, SETTING PROGRAM OPTIONS, to set the command. The DOS 
  276.         command is saved in file ASTROCLK.INI. Default is no action.
  277.         -Modified Interval Timer displays to include negative days. Range 
  278.         is now -999 to +9999 days on small window, -99 to +999 days on 
  279.         main window.
  280.         -Clarified text for Alarm & Interval Timer.
  281.         -Removed ESC key "cancel" codes except during external file 
  282.         searches and to quit ASTROCLK; RETURN is usually used where ESC 
  283.         was used before. F8 PRECESSION now requires "Y" or "y" to proceed 
  284.         and RETURN to cancel. Changed per user requests!
  285.         -Extensive minor editing and corrections to the documentation, 
  286.         principally related to the new features and changes in this 
  287.         version.
  288.  
  289.         8931      8/04/89   
  290.         -----------------
  291.    ASTROCLK Astronomical Clock and Celestial Tracking Program        Page 6
  292.         Program Revision History
  293.  
  294.         -Added most likely chart numbers for Sky Atlas 2000.0 and 
  295.         Uranometria 2000.0 on Target Tracking display, Display Mode 0.
  296.         -Corrected Interval Timer problem: if timer is non-zero and a 
  297.         date >32,767 days different from the timer start date was entered 
  298.         with F3, ASTROCLK aborted with QuickBASIC Error 6, OVERFLOW. 
  299.         Another oops!
  300.         -Added automatic conversion to JD for numeric dates greater than 
  301.         50 entered without a prefix when using F3. Prior versions would 
  302.         sometimes abort in this situation.
  303.